home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 018a / mpe4wp12.zip / README.MPE < prev    next >
Text File  |  1991-10-03  |  31KB  |  634 lines
  1.                              MPE4WP
  2.           MACRO PROGRAMMING ENVIRONMENT FOR WORDPERFECT
  3.  
  4.                  A Program by Michael H. Shacter
  5.                         7825 Marion Lane
  6.                     Bethesda, Maryland 20814
  7.  
  8.     MPE4WP is the Macro Programming Environment for WordPerfect.
  9. MPE4WP is a superior substitute to the WordPerfect Macro Editor.
  10. MPE4WP permits the creation and editing of WordPerfect macros on
  11. the full WordPerfect editing screen, using all the advanced
  12. editing features offered by WordPerfect.  (You may also use
  13. create macros using any text editor or word processor that saves
  14. text in ASCII format.)  MPE4WP includes programs that convert
  15. macros to and from text, and macros that improve upon the
  16. features of the macro editor, including a macro that emulates the
  17. macro recorder.
  18.  
  19.     This README file contains a brief description of MPE4WP with
  20. an overview of its features.  The User Reference Guide
  21. (MANUAL.MPE) presents a complete explanation of all MPE4WP
  22. features.  Incidentally, the length of the documentation is
  23. inversely proportional to the difficulty of using MPE4WP.  In
  24. other words, the documentation is long in order to cover all
  25. topics completely, but MPE4WP is very easy to use.
  26.  
  27.     All the MPE4WP features are described in detail in the
  28. accompanying User Reference Guide (MANUAL.MPE), which is
  29. formatted as a WordPerfect document.  A few of the features
  30. offered by MPE4WP are:
  31.  
  32.      ■  Insert Macro Commands, complete with tildes, using no
  33.         more than three keystrokes
  34.  
  35.      ■  Instantaneously switch back and forth between recording
  36.         and editing a macro
  37.  
  38.      ■  Use numbers rather than control or ASCII characters to
  39.         position characters on macro screens
  40.  
  41.      ■  Draw boxes using WordPerfect's line draw feature
  42.  
  43.      ■  Convert existing macros into ASCII text for further
  44.         editing or printing
  45.  
  46.      ■  Block, copy and move Macro Commands and text
  47.  
  48.      ■  Easily cut and paste routines from other macros
  49.  
  50.      ■  Use search and replace tools to debug and edit macros
  51.         quickly
  52.  
  53.      ■  Draft, edit and spell check text of any length for
  54.         inclusion in macros
  55.  
  56.      ■  Create and edit macros that are too big for the Macro
  57.         Editor
  58.  
  59.      ■  Employ the entire WordPerfect character set in your
  60.         macros, in a simple intuitive fashion
  61.  
  62.      ■  Use DOS wild cards to process several files in one
  63.         operation
  64.  
  65.      ■  Extend the number of ALT key macros from 26 to more than
  66.         130
  67.  
  68.     Until now, editing WordPerfect macros was not easy.  The
  69. built-in WordPerfect Macro Editor lacks all but the most
  70. primitive editing functions.  Even the simplest edits are
  71. difficult.  To move a line of code in the Macro Editor, the line
  72. must be deleted, one character at a time, then re-typed at its
  73. new location, with the hope that no errors will be introduced in
  74. the process.
  75.  
  76.     Some of these shortcomings are remedied by the ED program,
  77. available from WordPerfect Corporation for an additional fee.
  78. Unfortunately, you cannot access WordPerfect's menus, when using
  79. ED.  Therefore, you must know in advance the keystrokes that are
  80. necessary for your macro.  This can be difficult because
  81. WordPerfect has at least three sets of menus, each with its own
  82. keystrokes.  One set is for routine editing.  Another set comes
  83. into play when you Search for a code.  And still a third set
  84. becomes active when Block is on.
  85.  
  86.     The optimal macro editor should support all of WordPerfect's
  87. editing features and should allow instant access to and recording
  88. of all keystrokes required to use WordPerfect's menus.  MPE4WP
  89. fulfills these requirements and does much more.
  90.  
  91.     For example, MPE4WP includes a Record Mode that provides all
  92. the functionality of WordPerfect's macro recording, but with the
  93. additional capability of allowing you to record and edit
  94. interchangeably.
  95.  
  96.     Because of MPE4WP's memory conservation techniques, you may
  97. still create your macros without ever leaving WordPerfect, by
  98. using the Shell/Dos feature.  And MPE4WP's speed will
  99. considerably shorten the time required to create and edit macros.
  100.  
  101.     MPE4WP is suited for both advanced and novice macro.
  102. Beginning macro programmers will find all the tools needed to
  103. learn how to create macros for streamlining and customizing
  104. WordPerfect.  If you have been deterred from experimenting with
  105. macros by the aggravation attendant upon using the WordPerfect
  106. Macro Editor, now is the time to start learning.  Advanced macro
  107. programmers will have access to superior programming tools and
  108. will never be impeded with by safeguards for the beginners.
  109.  
  110.     MPE4WP consists of three tools to overcome the inadequacies
  111. of the WordPerfect Macro Editor:
  112.  
  113.     (1) MC.COM, the Macro Compiler, compiles (converts) ASCII
  114. text into WordPerfect macros.  MC.COM is blazingly fast and
  115. minimizes memory usage, so it can be used without ever leaving
  116. WordPerfect, by using the Shell/Dos feature.  MC.COM includes
  117. advanced features not available through the WordPerfect Macro
  118. Editor to simplify writing WordPerfect macros.
  119.  
  120.     (2) M2T.COM, the Macro Decompiler, reverses the task
  121. accomplished by MC.COM, converting WordPerfect macros into simple
  122. ASCII text.  You can use M2T.COM to examine, modify, or print
  123. macros created by yourself or others, outside the confines of the
  124. Macro Editor.
  125.  
  126.     (3) The Macro Programming Environment, which includes the
  127. MPE4WP keyboard and a series of macros, facilitates the creation
  128. of macros at the WordPerfect editing screen.  Macro Commands are
  129. no more than three keystrokes away and are inserted in your
  130. macros complete with tildes and the cursor correctly positioned
  131. to take the next argument.  Key Commands can be added by pressing
  132. the key represented by the command.  You may record keystrokes
  133. and access menus in the same manner as you would with the macro
  134. recorder, without leaving the editing screen.  Help screens are
  135. accessible with a single keystroke.  Incorrect Macro and Key
  136. Commands can be deleted by striking one key.
  137.  
  138.     MPE4WP is fully compatible with all releases of
  139. WordPerfect 5.1.  With three minor exceptions relating to Key
  140. Command syntax, MC.COM and M2T.COM are also compatible
  141. WordPerfect 5.0.  Of course, if you are still using WordPerfect
  142. 5.0, you must restrict yourself to the Macro and Key Commands
  143. available in version 5.0.  For a list of commands available in
  144. both versions 5.1 and 5.0, please see the file COMMAND.LST.
  145. Regrettably, the MPE4WP macros will not work in WordPerfect 5.0.
  146. Even without the MPE4WP macros, you will find yourself more
  147. productive at the normal WordPerfect editing screen or in your
  148. favorite editor than in the Macro Editor.
  149.  
  150.     Information concerning registration and licensing of MPE4WP
  151. may be found at the end of the User Reference Guide in the
  152. section entitled "REGISTRATION/LICENSE/COPYRIGHT".  In brief,
  153. there is a $15 registration fee for personal use of MPE4WP.  A
  154. license is required for business use.
  155.  
  156.  
  157. QUICK START
  158.  
  159.     The following Quick Start information is for those who
  160. resist reading documentation or who at least want to get their
  161. feet wet before taking the plunge.  Don't be discouraged if you
  162. are a novice and are confused by the Quick Start explanation.
  163. More detailed information in simple English is presented in the
  164. accompanying User Reference Guide (see the file MANUAL.MPE).  In
  165. addition, there is a Glossary for novices at the end of this
  166. document.
  167.  
  168.     The MPE4WP package contains the following files:
  169.  
  170.   README.MPE    MPE4WP Quick Start and Glossary
  171.  
  172.   MANUAL.MPE    MPE4WP User Reference Guide formatted as a
  173.                 WordPerfect document
  174.  
  175.       MC.COM    Macro Compiler described in MANUAL.MPE and
  176.                 README.MPE
  177.  
  178.      M2T.COM    Macro Decompiler described in MANUAL.MPE and
  179.                 README.MPE
  180.  
  181. MPE4WP-I.WPK    Integrated MPE4WP keyboard described in
  182.                 MANUAL.MPE and README.MPE
  183.  
  184.   MPE4WP.WPK    Alternative MPE4WP keyboard described in
  185.                 MANUAL.MPE and README.MPE
  186.  
  187. CMDS_A-L.WPM    MPE4WP operational macros for use with MPE4WP.WPK
  188. CMDS_M-Z.WPM    keyboard described in MANUAL.MPE and README.MPE
  189. {CREATE}.WPM    (Do not install these macro files, if you elect
  190. {EXPAND}.WPM    to use the MPE4WP-I.WPK keyboard)
  191.   {HELP}.WPM
  192. {INSERT}.WPM
  193.    {KEY}.WPM
  194. {RECORD}.WPM
  195. {SPCIAL}.WPM
  196.  
  197.   MPE4WP.WPK    MPE4WP keyboard described in MANUAL.MPE and
  198.                 README.MPE
  199.  
  200.  COMMAND.LST    List of Commands supported by MPE4WP
  201.                 described in MANUAL.MPE and README.MPE
  202.  
  203.  COMMAND.WPM    Test macro described in COMMAND.LST
  204.  
  205. REGISTER.FRM    Convenient form for registering MPE4WP
  206.  
  207.    WHATS.NEW    Information on changes from Version 1.0
  208.  
  209.     MPE4WP is furnished with two alternative keyboard files:
  210. MPE4WP.WPK and MPE4WP-I.WPK.  The MPE4WP.WPK keyboard works in
  211. tandem with an external set of macro files.  In contrast,
  212. MPE4WP-I.WPK is an integrated keyboard in which the macros have
  213. been incorporated into the keyboard file, eliminating the need
  214. for the external macro files.  Each approach has its advantages
  215. and disadvantages.  In favor of MPE4WP-I.WPK, fewer files are
  216. required, and the macros should execute more quickly on slower
  217. machines.  The advantage of MPE4WP.WPK is better memory
  218. conservation since the external macros are loaded and released
  219. from memory one at a time.  For most users memory economization
  220. will not be an issue, so MPE4WP-I.WPK will be the better choice.
  221.  
  222.     Complete installation instructions are set out in the User
  223. Reference Guide.  Copy either MPE4WP.WPK or MPE4WP-I.WPK to the
  224. same directory as your other macros and keyboard files.  If you
  225. opt for MPE4WP.WPK, the MPE4WP macro files (*.WPM) should also be
  226. copied to your macro directory.  (For information about locating
  227. the MPE4WP macros in a different directory, see the section
  228. entitled "{One-Key} Macros and XALT Keys" in the User Reference
  229. Guide.)  Ideally, MC.COM and M2T.COM should be placed in a
  230. directory on your path.  Now start WordPerfect, if you are not in
  231. it already, select the MPE4WP or MPE4WP-I keyboard file in Setup,
  232. and you are ready to use MPE4WP.
  233.  
  234.     MC.COM reads an ASCII text file (the "source file") and
  235. converts it to a WordPerfect macro.  If you are editing macros in
  236. WordPerfect, you must first save your source file in Generic WP
  237. format.  To save your source file in Generic WP format, press
  238. Text In/Out (CTRL-F5); now select 3 Save [A]s; then press 1
  239. [G]eneric.  You may also use the MPE4WP Save Generic macro
  240. (CTRL-G).  In general, the source file will look exactly the same
  241. as the text that appears on the screen when you call the
  242. WordPerfect Macro Editor to edit a macro with the exceptions
  243. noted below.
  244.  
  245.     Use ordinary spaces, not the centered dots (ASCII 250)
  246. utilized by the Macro Editor.  Tabs and hard returns are
  247. understood as formatting commands, just as they are by the Macro
  248. Editor.  Case is not important when entering Macro and Key
  249. Commands, but spelling is.  If you have any doubts about the
  250. correct spelling of a command, consult the COMMAND.LST file.  Use
  251. the MPE4WP macros described below and you will never have to
  252. worry about spelling errors.
  253.  
  254.     MC.COM expects that any text beginning with an open brace
  255. ({) is the beginning of a Macro Command, a Key Command, or one of
  256. the following special keys:  {ALT x}, where "x" is any legal
  257. character, {KEY MACRO n}, where "n" is the number of a Key Macro,
  258. or {VAR n}, where "n" is a number from 0 to 9.  (See the section
  259. entitled "{One-Key Macros and XALT Keys" in the User Reference
  260. Guide for a discussion of "legal" characters.)  If you want to
  261. treat the open brace as text, or if you want the command to
  262. appear as text, simply add an extra open brace, so your source
  263. file would look like this:  {{.  Failure to add an open brace
  264. before ordinary text will result in a harmless error message;
  265. MC.COM will still treat the open brace as text.  To treat a
  266. command as text (you usually won't), you must add the extra open
  267. brace.
  268.  
  269.     Instead of using cryptic Key Commands or ASCII characters in
  270. connection with the character positioning character code {^P},
  271. you may use the notation {n} (where "n" is any number between 0
  272. and 254) to represent column and/or row numbers.  Thus, if you
  273. want to position a prompt at column 3, row 65, you simply type
  274. {^P}{3}{65}.  The {n} notation may also used to enter any ASCII
  275. character between 1 and 254 and is strongly recommended for
  276. control codes (ASCII 1 to 31).  For information on how
  277. WordPerfect's automatic paragraph numbering may be advantageously
  278. employed in connection with MPE4WP's character positioning
  279. notation, see the section in the User Reference Guide entitled
  280. "Making Boxes with MPE4WP".  The command {0} is correctly
  281. interpreted as the appropriate WordPerfect code (ASCII 254) to
  282. position the cursor at column or row 0.  Any character in the
  283. WordPerfect character set may be entered using the shorthand
  284. command {s,n}, where "s" is the number of the character set and
  285. "n" is the number of the character within the set.  Thus, the
  286. copyright symbol--"C" in a circle--which is character number 23
  287. in character set number 4, would be {4,23}.
  288.  
  289.     In addition to the WordPerfect macro comment ({;}), MPE4WP
  290. also supports silent comments, which are ignored when MC.COM
  291. compiles your macro.  The beginning of a silent comment is marked
  292. by a colon in braces: "{:}" and, like the WordPerfect comment,
  293. terminated by a tilde.  For example, {:}This is a silent
  294. comment~.
  295.  
  296.     A macro may contain an optional description.  The
  297. description should be preceded by the command {DESCRIPTION}
  298. (upper-case, lower-case or any combination of the two is ok) and
  299. terminated by either a tilde or a hard return.  WordPerfect
  300. imposes a 39-character limitation on the length of a description,
  301. so MC.COM will truncate any description that is longer than 39
  302. characters.  The description may be on a line by itself or on a
  303. line with other commands.  To minimize complication, place the
  304. description at the top of the macro source file.  The description
  305. may, however, be placed anywhere within the first 4000 characters
  306. of the source file.  If you have a reason for using the command
  307. {DESCRIPTION} as text, precede it with an extra open brace, like
  308. this:  {{DESCRIPTION}.
  309.  
  310.     You may also use the optional notation {MACRO CMD n} and
  311. {KEY CMD n}, where "n" is the number of a Macro or Key Command.
  312. The main use of this feature is to allow access to new Macro and
  313. Key Commands added in any future interim releases of WordPerfect.
  314. For more information on this feature, see the section entitled
  315. "Anti-Obsolescence" in the User Reference Guide.
  316.  
  317.     Once you have created your source file, you compile it (i.e.
  318. convert it to an operational macro) with MC.COM.  To run MC.COM
  319. you only need to type MC at the DOS command line (assuming MC.COM
  320. is on your path).  Alternatively, you may run MC.COM from within
  321. WordPerfect.  The simplest way to run MC.COM from within
  322. WordPerfect is to use the MPE4WP Create macro (CTRL-C).  If
  323. MC.COM is not on your path, you should edit the Create macro,
  324. following the instructions at the beginning of the macro, to
  325. specify the full path name of MC.COM.  (Editing Create to specify
  326. the full path name is a good idea, even if MC.COM is on your
  327. path.  For additional information about editing Create, see the
  328. section entitled "Create" in the User Reference Guide.)
  329. Otherwise, you type CTRL-F1 (Shell) and select 2 DOS [C]ommand.
  330. Now type MC at the DOS Command prompt.  If MC.COM is not on your
  331. path, you should give the full path name.
  332.  
  333.     MC.COM will prompt you for the name of your source file and
  334. the name of your macro file.  MC.COM provides on-screen
  335. instructions and helps you correct errors.
  336.  
  337.     For your convenience, MC.COM also permits you to enter
  338. optional commands when you start the program.  The full syntax
  339. for MC.COM is:
  340.  
  341.              MC [/M] [/N] [Source file] [Macro file]
  342.  
  343.     The brackets ([]) are not typed and indicate that the
  344. parameters are optional.  The options have the following
  345. meanings:
  346.  
  347.     /M              Force monochrome display
  348.  
  349.     /N              No error file.  Tell MC.COM not to create
  350.                     the file MC.ERR.  For additional information
  351.                     on MC.ERR, please see the User Reference
  352.                     Guide.
  353.  
  354.     Source file     The name of the file that will be converted
  355.                     to a macro.  Full path names and wild cards
  356.                     are permitted.  If you specify a source file
  357.                     only and do not specify a macro file name,
  358.                     the new macro will be placed in the same
  359.                     directory as the source file with the same
  360.                     root name and the extension "WPM".
  361.  
  362.     Macro file      The name of your new macro.  If you specify
  363.                     the destination directory only and do not
  364.                     specify a macro file name, the new macro
  365.                     will have the same root name as the source
  366.                     file and the extension "WPM".  If you
  367.                     specify a macro file name only and do not
  368.                     specify a path, the macro will be placed in
  369.                     the default directory.  If you omit the
  370.                     extension of the macro file, the extension
  371.                     "WPM" will be added.  In wild card
  372.                     operations, only the destination directory
  373.                     may be specified.
  374.  
  375.     If you make a mistake at the command line entering the
  376. source file or the macro file, MC.COM will advise you of the
  377. error and assist you in remedying it.
  378.  
  379.     You use M2T.COM to decompile macros; i.e. convert them to
  380. ASCII text.  M2T.COM is similar in operation to MC.COM.  You run
  381. M2T.COM by typing M2T at the DOS command line or from within
  382. WordPerfect.  You will be prompted for the name of your macro
  383. file and the name of your text file.  If an existing macro
  384. contains a description, M2T.COM will automatically add a
  385. description statement to the top of the output file.
  386.  
  387.     Before processing a file, M2T.COM will verify that it is a
  388. macro file.  Where possible, M2T.COM offers a choice of
  389. overriding its conclusion.  You may also terminate processing,
  390. revise the file name when processing a single file, or skip to
  391. the next file in a wildcard operation.
  392.  
  393.     For your convenience, M2T.COM also permits you to enter
  394. optional commands when you start the program.  The full syntax
  395. for M2T.COM is:
  396.  
  397.                 M2T [/M] [Macro file] [Text file]
  398.  
  399.     The brackets ([]) are not typed and indicate that the
  400. parameters are optional.  The options have the following
  401. meanings:
  402.  
  403.     /M              Force monochrome display
  404.  
  405.     Macro file      The name of the macro file that will be
  406.                     converted to text.  Full path names and wild
  407.                     cards are permitted.  The extension "WPM"
  408.                     will be added if you omit an extension.  If
  409.                     you specify a macro file only and do not
  410.                     specify a text file name, the text file will
  411.                     be placed in the same directory as the macro
  412.                     with the same root name and the extension
  413.                     "TXT".
  414.  
  415.     Text file       The name of your text file.  If you specify
  416.                     the destination directory only and do not
  417.                     specify a text file name, the text file will
  418.                     have the same root name as the macro and the
  419.                     extension "TXT".  If you specify a text file
  420.                     name only and do not specify a path, the
  421.                     macro will be placed in the default
  422.                     directory.  If you omit the extension of the
  423.                     text file, the extension "TXT" will be
  424.                     added.  In wild card operations, only the
  425.                     destination directory may be specified.
  426.  
  427.     MPE4WP is supplied with a set of macros to simplify creating
  428. and editing macros at the WordPerfect editing screen.  Each macro
  429. is assigned a key on one of the MPE4WP keyboards.  The MPE4WP-I
  430. uses Key Macros exclusively.  The MPE4WP keyboard uses a
  431. combination of Key Macros and {One-Key} Macros.  A {One-Key}
  432. macro is a Key Macro in the form "{Macro}[drive:\path\]macroname
  433. {Enter}".  {One-Key} Macros may be assigned to any key that is
  434. recognized by WordPerfect.  Like ALT keys and XALT keys, a
  435. {One-Key} Macro can be both defined and run with a single
  436. keystroke.  For more information on how to create and use
  437. {One-Key} Macros, please see the section entitled "{One-Key}
  438. Macros and XALT Keys" in the User Reference Guide.
  439.  
  440.     The following table lists each of the MPE4WP macros,
  441. identifies the key to which it is assigned, and summarizes the
  442. use of each key.  The macro file associated with the key on the
  443. MPE4WP keyboard is also listed.  (Note:  The macro file name is
  444. irrelevant to the MPE4WP-I keyboard because all its macros are
  445. Key Macros.)  You will notice that the root names of many of the
  446. MPE4WP macros are enclosed in braces.  The purpose of the braces
  447. is to avoid name conflicts with existing macros.  You may already
  448. have a macro named CREATE.WPM, but are unlikely to have one named
  449. {CREATE}.WPM.  The operation of all macros is described in detail
  450. in the User Reference Guide.
  451.  
  452.                          MPE4WP MACROS
  453.  
  454.  
  455. Name          Key     File name     Summary
  456.  
  457. Help          CTRL-H  {HELP}.WPM    Just what its name suggests
  458.  
  459. Record Mode   CTRL-R  {RECORD}.WPM  Record keystrokes in
  460.                                     WordPerfect in an analogous
  461.                                     manner to macro recording
  462.  
  463. Insert Mode   CTRL-I  {INSERT}.WPM  Insert Key Commands in an
  464.                                     analogous manner to the Macro
  465.                                     Editor's Command Insert Mode
  466.  
  467. Key           CTRL-K  {KEY}.WPM     Insert a single Key Command
  468.                                     in an analogous manner to
  469.                                     pressing CTRL-V in the Macro
  470.                                     Editor
  471.  
  472. Special Keys  CTRL-S  {SPCIAL}.WPM  Insert the commands {ALT x},
  473.                                     {KEY MACRO n} and {VAR n}
  474.  
  475. Macro         CTRL-{  CMDS_A-L.WPM  Help screen of Macro Commands
  476. Commands                            from A to L; insert a command
  477. (A-L)                               (with tildes) by typing
  478.                                     two-key mnemonic
  479.  
  480. Macro         CTRL-}  CMDS_M-Z.WPM  Help screen of Macro Commands
  481. Commands                            from M to Z; insert a command
  482. (M-Z)                               (with tildes) by typing
  483.                                     two-key mnemonic
  484.  
  485. Expand        CTRL-X  {EXPAND}.WPM  Type two-key mnemonic then
  486.                                     press CTRL-X to expand to
  487.                                     Macro Command with tildes;
  488.                                     uses same mnemonics as CTRL-{
  489.                                     and CTRL-}, but without help
  490.                                     screens
  491.  
  492. Delete        CTRL-D  Key Macro     Delete Macro or Key Command
  493.                                     on which cursor is located;
  494.                                     if cursor is not on a
  495.                                     command, delete first command
  496.                                     to left
  497.  
  498. Create        CTRL-C  {CREATE}.WPM  Run MC.COM from within
  499.                                     WordPerfect
  500.  
  501. Save Generic  CTRL-G  Key Macro     Save file in Generic Word
  502.                                     Processing format
  503.  
  504. Clear Prompt  CTRL-   Key Macro     Clear status prompt from
  505.               Print                 screen in the event of
  506.               Screen                unanticipated errors
  507.  
  508. Playback      CTRL-P  Key Macro     Play back recording in case
  509.                                     of unanticipated
  510.                                     interruptions
  511.  
  512.     If you have questions about any instructions contained in
  513. the Quick Start section of this document, please refer to the
  514. User Reference Guide (MANUAL.MPE).  The User Reference Guide also
  515. discusses subjects such as Key Macros and Programming Tips, that
  516. are not addressed in this document.  The balance of this file is
  517. devoted to a few definitions that may be instructive to novice
  518. macro programmers.
  519.  
  520.  
  521. GLOSSARY
  522.  
  523.     "ASCII characters".  Simply put, ASCII characters are the
  524. characters that appear on your computer's screen and in simple
  525. text files.  The ASCII character set is generally thought of as
  526. being composed of three divisions.  The first 31 ASCII characters
  527. are referred to as control codes.  They often have funny
  528. appearances, like the happy faces, and usually are not
  529. incorporated in text (with the exception of  and , ASCII 20 and
  530. 21, respectively).  The control codes also include text
  531. formatting characters like the hard tab (ASCII 9), carriage
  532. return (ASCII 13), and line feed (ASCII 10).
  533.  
  534.     The next 64 characters (ASCII 32 through 127) include the
  535. alphabet, numerals, and punctuation characters.  ASCII characters
  536. 0 through 127 are called the lower ASCII set.  The upper ASCII
  537. set consists of characters 128 through 255, and includes foreign
  538. language characters, line drawing characters, and mathematical
  539. symbols.
  540.  
  541.     "ASCII text".  ASCII text refers to text without any special
  542. formatting features.  (Formatting features include margin
  543. setting, centering, underlining, and all the other special
  544. features a word processor adds to simple text.)  Each character
  545. in ASCII text has the meaning commonly assigned to that
  546. character.  In contrast, word processing text includes ASCII
  547. characters that are assigned a special meaning by the word
  548. processing program.  For example, a word processing program might
  549. treat the upper ASCII characters £ and ¥, taken together, as an
  550. instruction to begin underlining.  The two characters would lose
  551. their commonly accepted meaning as the symbols for the pound and
  552. the yen, and together would take on the new meaning "begin
  553. underline here".
  554.  
  555.     "Full path name".  The full path name of a file includes the
  556. name of the disk drive it is located on, the directory it is
  557. located in, and the name of the file.  An example would be
  558. C:\WP51\MACROS\MYMACRO.WPM.  Notice that the disk drive is
  559. followed by a colon and that each of the directories is followed
  560. by a backslash.  A lone backslash refers to the root directory.
  561.  
  562.     "Current or default directory".  The current or default
  563. directory, as the name suggests, is the directory that DOS looks
  564. in when you give a file command that does not specify another
  565. directory.
  566.  
  567.     "Path".  Path is a command that tells DOS which directories
  568. to search when you instruct it to run a program without
  569. specifying the full path name.  DOS will first look in the
  570. default directory, then will search the other directories on your
  571. path.  The path is usually set in your Autoexec.bat file.
  572. Suppose, for example, that you have just booted your computer,
  573. and you are in the root directory of the C: drive.  If you have
  574. set your prompt to give the current directory, you will see
  575. "C:\".  Suppose further, that the WordPerfect program "WP.EXE" is
  576. located in the directory "C:\WP51".  If your were to type WP
  577. followed by enter and the program WP.EXE was not on your path,
  578. you would get the message "Bad command or file name".  On the
  579. other hand, if "C:\WP51" is on your path, DOS will search through
  580. that directory and run WordPerfect for you.
  581.  
  582.     "Root name and extension".  A file's root name consists of
  583. that portion of the filename up to the period.  All files have a
  584. root name which may be up to 8 characters long.  The extension is
  585. usually optional.  It refers to the characters (no more than 3)
  586. following the period.  The root name of the file "MYMACRO.WPM" is
  587. "MYMACRO"; the extension is "WPM".  The case of a character in a
  588. file name does not matter, because DOS converts all file names to
  589. upper-case.
  590.  
  591.     "Wild cards".  DOS wild cards refer to the characters "*"
  592. and "?".  The "*" can be substituted for any string of characters
  593. in a file name.  The "?" can be substituted for any single
  594. character.  Wild cards may be used by MC.COM and M2T.COM to
  595. process more than one file at a time.  I hate to say this, but if
  596. you need more information about wild cards, please see your DOS
  597. manual.  PC Magazine's DOS Power Tools is an excellent source of
  598. information about MS-DOS.  A knowledge of wild card usage is not
  599. required to utilize the MPE4WP tools satisfactorily.
  600.  
  601.     "Macro Editor".  Refers to the built in WordPerfect macro
  602. editor.
  603.  
  604.     "Compiler and source file".  A compiler converts text
  605. instructions contained in a source file into machine language.
  606. The contents of a source file are sometimes referred to as the
  607. source code.  The source file converted by MC.COM, the Macro
  608. Compiler, looks almost the same as the text of a macro in the
  609. Macro Editor.  This source file is converted by MC.COM into an
  610. executable WordPerfect macro.  Why call MC.COM a compiler instead
  611. of a conversion program?  First, because it is an accurate
  612. description.  And second, because it's more fun and gives one a
  613. feeling of importance.
  614.  
  615.     "Screen".  A screen refers to one of many types of prompts
  616. that may be created in WordPerfect macros.  A screen may be as
  617. simple as a bottom line prompt or as complex as a full screen
  618. display with mnemonic prompts, as are found in some of the MPE4WP
  619. macros.
  620.  
  621.     "Macro Command and Key Command".  WordPerfect macros employ
  622. two special types of commands to control the operation of the
  623. macro.  These are Macro Commands and Key Commands, both are
  624. enclosed in braces ({}).  The Macro Commands are special
  625. programming commands that apply only to macros, such as
  626. {DISPLAY ON} and {IF}.  They are accessed in the Macro Editor by
  627. pressing the Ctrl-PgUp key.  Key Commands are representations of
  628. the keys that you customarily use at the WordPerfect editing
  629. screen, including {Spell}, {Tab}, and {Format}.  In the Macro
  630. Editor, Key Commands appear as all upper-case, while Key Commands
  631. are in initial capital letters.  A complete list of Macro and Key
  632. Commands presently supported by WordPerfect and MPE4WP is
  633. included in the file COMMAND.LST.
  634.